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FlexNet kernel extension for network node services 


This is not a complete documentation. The reader should also read the 
printed sysop documentation of FlexNet V3.3. 
This file only mentions briefly the special features of PC/FlexNet. 


= Hardware and software requirements 
PC/XT or better a PC/AT with at least 512kB RAM 
PC/FlexNet requires about 200kB RAM plus the RAM needed by the 
channel drivers and utilities. Digipeaters with many ports require 
more memory 
= Operating system 
MS-DOS version 3.1 or later, preferably 5.0 or 6.2, where parts of the 
package may be loaded into the UMBs 
= Interfaces 
As needed (see available channel drivers) 


- A PC/XT should basically suffice. The achievable data rate depends largely 
on the speed and throughput of the channel drivers. 


= PC/FlexNet supports loadable L1 drivers (or channel drivers). They are 
installed in memory simply by calling them. Therefore it is very easy to 
support any interface. A "driver kit" is available for interested 
developers. 


- Channel numbers are allocated in ascending order of the driver 
installation. A driver may support any number of channels. FlexNet however 
supports at most 15 channels. 


- FLEXNET.EXE, the channel drivers and other extensions may be deinstalled 
by calling "FLEX.EXE /U". DOS however requires that there were no other 
TSRs loaded after FLEXNET, otherwise the machine may crash. 


7 The whole installation is usually done with a batch file, because most 
channel drivers need command line parameters. Error conditions are 
reported back to COMMAND.COM, and the batch file should terminate the 
installation. 


- FLEXNET.EXE must always be loaded first. Then the channel drivers 
should be called in the desired order. After that, FLEXDIGI.EXE should 
be loaded for network nodes. Then the modules must be activated 
by calling the utility "FLEX". After activation, channel driver 
installation is refused. 


- The size of the used data memory may be specified as an optional command 
line parameter to FLEXNET.EXE. Depending on the number of channels, 
the sysop should experiment with different settings. FlexNet loves memory 
very much, reasonable values are for example 60kB for a small node with 
2 links or 120kB for a big node with 8 links and a heavily used BBS at 
one of its ports. 
WARNING: The default is 15kB, which suffices for a user station, but this 
is by far too few memory for a network node! 


= Channel drivers are included in the package if available. Every channel 
driver comes with a .DOC file with the same name that explains its 
installation. Every driver also displays a short help text if called with 
/? that explains its parameters. 


Tests with MS-DOS 6.0 showed problems, and there is no experience with 
DR-DOS. The author suggests the use of MS-DOS 5.0 or 6.2. This allows 

the modules to be loaded into UMBs if there is sufficent memory. 

To load the modules (with MS-DOS 5.0 or later), use "LOADHIGH" or "LH", 
it doesn't hurt; if there is not enough memory in the UMBs, the modules 
are loaded into the conventional memory. Even in this case memory can be 
saved, since the environment block does not leave a gap in the memory. 
"MEM /D" shows the memory usage. 


The first start of FLEXDIGI.EXE generates an empty parameter file. On 
should now (or even before the first start of FLEXDIGI) set the sysop 
secret number with "SYSNUM.EXE". 


"TNC.EXE" is a simple TNC emulation, that may be started if needed. 
"<ESC>H" shows a short help text, the fil "RM TERM.DOC" from the 
NC/FlexNet distribution may also be consulted. 

hannel 15 is used as internal channel where applications are coupled 
o the digipeater. It is parameterized for automatic sysop access. 

ne can, therefore, connect the digipeater with "TNC.EXE" and adjust 
he other parameters. 
f one gets stuck, one may simply delete the file "FLEXNET.FPR" and start 
ver. 

EXNET.FPR is not directly editable. Checksums prevent inadvertent 
hanges. 
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The texts for 'C', 'A', 'I', 'H', 'L' and 'S' are stored in separate text 
files with the extension ".FPR". These files may be loaded either remotely 
or created directly with an editor. 

The parameterization is except for some details identical to the RMNCs. 
Some paramteres are driver specific, see DOC files and the online help! 
WARNING: The FPR files are normally put into the same directory as the 

EXE files. In some cases it may be useful to put them into a different 
directory. Another directory may be specified by for example the DOS 
command "SET FLEXNET=C:\FLEXNET\PAR". The path may be absolute or relative 
to the path of the EXE files. "SET FLEXNET=PAR" therefore sets th 

working directory to C:\FLEXNET\PAR if the EXE files reside in C:\FLEXNET. 
The SET command must be issued before loading the FlexNet modules! 

The directory must be created by hand, if it is not found, an error message 
is issued. 


Note: PC/FlexNet runs completely in the background as a TSR. Arbitrary 
applications may therefore run simultaneously if the remaining memory 
suffices. The FlexNet infobox and the beacon generator however may in 

some cases cease to be serviced. Then QSOs with the node become impossible. 
This however happens only with uncleanly programmed applications or 
monsters like MS-Windows. 

QSOs over the digi or the internodecommunications are not touched by this 
effect and should work what ever the PC has to do, only the speed may 
suffer a bit. 


PC-FlexNet is currently in the beta test state, although the version number 
3.3 suggests a final release. This version number was chosen to be the sam 
as the RMNC version number, as the features implemented in the RMNC and 

the PC versions are the same. No exhaustive performance tests have been 
carried out. If the software runs too slow, please send a mail to the 
author and describe the working conditions. There are most likely places 
where fine tuning may increase the performance, but these places hav 

to be identified first. 


Additional features may not be implemented anytime soon, especially 
"toys" and comfort functions. The RMNC is still the preferred platform 
for FlexNet, and features that do not work there will not be implemented 


on the PC, except for minor details. 

The users should encounter an uniform and already from the RMNC known user 
interface. 

The goal of the development was the creation of a easy to use and robust 
network node software that annoys users and operators the least possible. 
Everyone who wants optimal reliability and speed at minimal operating and 
maintenance costs should switch to RMNC. 


Note: The legal terms below are for your informational purposes only. They 
do not replace the german version. 


Copyright and the inevitable legal terms 


Preamble: The following restrictions serve the purpose to get consistency 
and maintainability and, of course, to exclude commercial applications, 

as long as they are not negotiated with the authors of the modules involved. 
Experience shows that with uncontrolled distribution only parts or outdated 
Versions are distributed. 

This results in problems for the users and unnecessary and annoying mails. 
Bad experiences make the following paragraphs grow: 


- RMNC/FlexNet, PC/FlexNet and the accompanying utilities and documentation 
are a product of Gunter Jost, DK7WJ. Exceptions are marked. All rights 
remain at the author. The user has the right to use the software under 
the following conditions: 


= The software may only be used noncommercially for amateur radio. Every 
other use, especially in other radio services, needs in every case th 
written consent of the author. 


- The legal regulations concerning amateur radio are met. 


- Commercial copying and selling without the written consent of the 
author is prohibited. Also, the software must not be bundled with 
commercially sold components (for example modems) without the 
written consent of the author. In every case the customer must be 
informed in writing that he does not acquire further rights concerning 
the software. 


= The software must not be patched or changed. Changing parameters 
however is allowed. 


= Copyright notices must not be removed or changed from the software 
modules and documentation. 


= The software must not, neither in part nor wholly, published over 
PBBS systems or publicly accessible mailboxes. 


- The authors or distributors of this software assume no responsibility 
or liability for any harm that results from using this software. 


The use of this software implies accepting the above legal terms. 


.a few wishes 


- Feedback of every kind is always welcome. It is not forbidden to write even 
if everything works well. Please keep BBS inquiries short! Please mark 
questions clearly and number them, do not hide them in 10kB text or 
trace dumps! This hugely speeds up response time. 


- Before telephoning, please contact the author via BBS mail! 
Now we wish you much fun and few annoyances and much success! 
73 Gunter, DK7WJ 
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Extension du noyau FlexNet pour digipeater 


Ce fichier ne constitue pas une documentation complate. I1 complate 
simplement la documentation SySop de FlexNet V3.3. 


Voici les quelques particularitCs de PC/FlexNet 

= configuration materielle / logicielle 
PC/XT, ou mieux AT avec un minimum de 512 Ko RAM 
PC/Flexnet utilise environ 200 Ko de RAM, sans compter la place occupCe 
par les diffCrents drivers et utilitaires. Si vous utilisez plusieurs 
ports, prCvoyez une mCmoire plus importante. 


Systame d'exploitation 


A partir de MS-DOS 3.1, ou mieux 5.0 ou 6.2, de fadon O stocker une 
partie des paquets dans les UMBs. 


Sorties 
En fonction de vos besoins et des drivers utilisCs. 


- Cot€ hardware, un PC/XT peut suffire. La puissance du systame dCpendra 
de la rapidit¢ et du taux de transfert des drivers materiels. 


- PC/FlexNet utilise des drivers Ll charg¢s en mCmoire. Ils s'installent 
imm¢Cdiatement en mC€moire apras leur lancement. Il est ainsi tras facile 
d'utiliser n'importe quel port, n'importe quelle sortie. Un "kit driver" 
est disponible pour les dCveloppeurs intCressCs. 


- Les numCros de canaux sont attribuCs dans l'ordre de lancement des diffCrents 
drivers. Un driver peut utiliser plus d'un canal, mais FlexNet ne peut en 
avoir lui que 15 pour le moment. 


- En landant FLEX.EXE avec l'option "/U", tous les modules installCs seront 
d¢charg¢Cs de la mCmoire. 

Comme © chaque fois sous DOS, il ne faudra pas charger d'autres TSR sous 
peine de subir des plantages du systame. Lancez PC/FlexNet en dernier. 


- La totalit¢ de l'installation se fera au moyen d'un fichier BAT. Celui-ci 
lancera alors tous les drivers avec leurs paramatres. En cas d'erreur, 
le COMMAND.COM stoppera la mise en place. 


- FLEXNET.EXE doit atre lanc¢ le premier, suivi des drivers dans l'ordre 
souhaitC, puis de FLEXDIGI.EXE si vous utilisez la fonction digi. Vient 
alors l'activation du systame par l'utilitaire "FLEX". Plus aucun 
driver ne pourra alors atre chargC. 


- FLEXNET.EXE peut atre exCcut¢ avec un paramatre optionnel dCfinissant la 
taille du buffer de donnCes. Ce sera © vous de dCterminer s'il vous faut 
augmenter la taille par dCfaut de 15 Ko ou non. FlexNet a avant tout besoin 
de mCmoire. Par exemple, il est judicieux d'utiliser 60 Ko pour un petit 
node avec deux voies radio, mais 128 Ko si vous avez 8 liaisons et un BBS 


avec beaucoup de trafic. 
ATTENTION : 15 Ko suffisent pour un utilisateur normal, mais c'est trop peu 
pour un digi. 


- Les drivers sont fournis dans ce package, en fonction de leur disponibilit¢. 
Chacun d'entre eux dispose d'un fichier DOC dCcrivant son fonctionnement 

et son installation. En outre, lancer un driver en ajoutant "/?" vous 
permettra d'avoir une aide rapide sur la syntaxe et les possibilit¢Cs. 


- Des essais avec MS-DOS 6.0 ont montr¢ des problames. Nous n'avons pas encore 
pu tester DR-DOS. Nous vous recommandons d'utiliser MS-DOS 5.0 ou 6.2. 

Les modules auront ici assez de mCmoire et pourront se charger dans les 

UMBs si vous utilisez "LOADHIGH" ou "LH". S'il ne reste pas assez de RAM, 

le module se chargera tout simplement en mCmoire conventionnelle. "MEM /D" 
peut vous aider © gagner de la place en analysant les drivers dCjO en 
service et la place qu'ils occupent. 


- Un fichier de paramatrage vide sera crC¢C lors du tout premier lancement 
de FLEXDIGI.EXE. Choisissez alors le code SySop en utilisant "SYSNUM.EXE". 


"TNC. EXE" est une Cmulation simplifiCe de TNC pouvant atre utilisCe pour 
des besoins ponctuels. "<ESC> H" vous affichera une aide rapide sur les 
commandes disponibles, semblables 6 celles contenues dans le fichier 
"RM TERM.DOC" livr€ avec RMNC/FlexNet. 
Le canal 15 est prCvu pour le dialogu n interne avec des applications, 
sur le mame PC que le digi, et est automatiquement paramCtrC pour 
une utilisation en mode SysOp immCdiat. 
En utilisant "TNC.EXE", vous pourrez vous connecter © votre digi et en modifier 
l'intCgralit¢ des paramatres. 


Si vous rencontrez le moindre problame ou si vous voulez effacer la totalitc 

de la configuration, effacez simplement le fichier "FLEXNET.FPR" et recommencez 
depuis le dCbut. FLEXNET.FPR ne peut atre directement CditC car il est protCgC 
par des octets de contr"le, empachant toute altCration en cas de plantage. 


- Les textes pour 'C', 'A', 'I', 'H', 'L', et 'S' sont stock¢s dans des 
fichiers textes sCparCs ayant l'extension ".FPR". Vous pouvez modifier ces 
fichiers O distance (ex : WRITE C) ou directement les Cditer. 

Le parametrag st O quelques dCtails pras identique 0 celui des RMNCs. 

Dans la plupart des cas, des fichiers DOC et de l'aide on-line sont disponibles 
pour chacun des drivers. 


ATTENTION : les fichiers devront figurer dans le mame rCpertoire que les 

.EXE. Dans certains cas, il peut atre utile de les placer ailleurs. On utilise 
alors la commande DOS "SET FLEXNET=C:\FLEXNET\PAR", par exemple. 

Le chemin peut atre indiquC de faaon absolue ou relative, en fonction du 
rCpertoire utilise par les fichiers .EXE. Par exemple, "SET FLEXNET=PAR" 

fera rCfCrence au rCpertoire C:\FLEXNET\PAR, les fichiers .EXE se trouvant 
dans C:\FLEXNET. 

La commande SET doit atre utilisCe avant le chargement des modules FlexNet. 
Une erreur se produirea si le rCpertoire n'est pas trouvc. 


- Conseil : PC/FlexNet fonctionne complatement en tache de fond, en TSR. Il 
est de ce fait possible de faire tourner d'autres applications en mame temps, 
dans la limite de la taille mCmoire restant disponible. L'infobox et le 
gCnCrateur de balises du FlexNet ne sont alors plus utilisCs le cas CchCant, 
aucun dialogue avec le digi n'Ctant alors possible. Ce problame survient avec 
des application mal Ccrites ou des monstres comme MS-Windows. Les QSO 0 
travers le digi et les communications internodes ne sont par contre pas 
affectCes. Ils doivent toujours fonctionner, quoi que le PC soit en train 

de faire, avec un 1Cger ralentissement. 


- PC/FlexNet est pour le moment en version Betatest, mame si le numCro de 
version suggare une compatibilit¢ avec FlexNet 3.3. Il a CtC conserv¢ ainsi 
pour ne pas apporter de confusion par rapport O la version fonctionnant sur 
RMNC. Des tests intensifs n'ont pas encore CtC effectuCs. Si vous trouvez 
que le logiciel fonctionne trop lentement; envoyez un message © l'auteur 

en indiquant votre configuration pr¢€cise. Il est probable qu'un simple 
r€glage puisse tout amCliorer, mais il est avant tout nCcessaire 

de savoir o- et comment le problame survient. 


- L'ajout de nouvelles fonctions ne se fera pas tout de suite. Le RMNC reste 

la plateforme initiale de d¢Cveloppement de FlexNet. Tout ce qui ne fonctionnera 
pas dessus ne sera pas impl¢Cment¢ sur PC. L'utilisateur doit trouver des 
fonctions identiques, dCjO implCmentCes sur les RMNCs. 

L'objectif du d¢Cveloppement est d'avoir un logiciel de digi simple d'emploi 

et robuste, utilisable sans problames. Ceux qui recherchent avant tout 

vitess t suretC avec rapidit¢ de mis n oeuvre, devront avant tout se 
tourner vers RMNC. 


Copyright et droits d'utilisations 


- PrNambel: Die folgenden Restriktionen haben lediglich den Zweck, Konsistenz 
und Wartbarkeit zu erreichen und natArlich kommerzielle Anwendungen auszu- 
schlie-en, soweit sie nicht mit den Autoren der einzelnen Module abgespro- 
chen sind. ErfahrungsgemN: passiert es bei einer unkontrollierten Verbrei- 
tung, da: nur Teile der Software oder veraltete Versionen weitergegeben 
werden. 


Cela cause des problames chez les utilisateurs, et de ce fait bon 
nombre de questions inutiles et totalement dCpassCes. Nos expCriences 
passCes nous obligent © conserver le paragraphe suivant 


- RMNC/FlexNet, PC/FlexNet, tous les logiciels d'aide et les 
documentations sont un produit de Gunter Jost, DK7WJ. Tous 
les droits reviennent © l'auteur. L'utilisateur n'a que le droit 
d'utiliser le logiciel en respectant les conditions suivantes 


= Le logiciel ne doit pas atre utilis¢ dans un but commercial, mais 
uniquement pour des applications radioamateurs. 


= La rCglementation radioamateur devra atre respectCe. 


- Un usage industriel et la vente du logiciel ne sont possibles 
qu'tavec l'accord Ccrit de tous les auteurs. 


- Aucune modification ne peut atre apportCe au logiciel, sans en avoir 
discut¢ avec l'auteur. Le paramatrage de chaque systdame ne rentre 
pas dans cette clause. 


- Les textes et les messages de copyright des logiciels ne doivent pas 
atre supprimCs ou modifiCs. 


- Le logiciel ne doit pas atre transmis en morceaux ou dans son 
intCgralit¢ sur les BBS ou tout autre type de serveur. 


- Les auteurs et les distributeurs du logiciels ne peuvent atre tenus 
pour responsable d'Cventuels dommages ou autres problames 1iCs 0 
la mise en place et O l'utilisation du logiciel. 


L'utilisation du logiciel suppose l'acceptation des conditions ci-dessus. 


ncore quelques souhaits 


- Vos impressions sont les bienvenues. N'hCsitez pas non plus O envoyer un 
message si tout fonctionne bien. Evitez les demandes par BBS et rCduisez les 
au minimum. Posez vos question en restant le plus clair possible, en Cvitant 
de m'envoyer 10 Ko de texte ou de mode Trace ! Cela amCliorera le temps 
de rCponse. 


- Me contacter au prCalable par BBS avant tout contact tClCphonique ! 


Maintenant, je vous souhaite de bien vous amuser, et de ne pas rencontrer 
trop de problames ! 


73 Gunter, DK7WJ 


